SmallC Cross Compiler to 68HC11.
Release Notes.
Sept. 1, 1987

This file lists and describes the files included in a release.
It also discusses the release history of this program,
and known bugs and limitations.




Files included in a release:

xcc11 - executable (double clickable) application.

xcc11run.asm - assembler source file for the run-time support.  
SmallC generates code which calls subroutines for those functions not
supported by simple machine language instructions.  This is done to 
trade execution speed for code compactness. For any particular c program,
you can edit out those run-time support subroutines that the program
does not use.  This file starts with some assembler pseudo-ops that
have to do with the location of data and code.  Then comes code that 
initializes the machine.  Then come the run-time routines.
This file can be conveniently included from a c source file after
bracketing this file with #asm and #endasm.

xcc11relnotes.text - This file.

The source for the compiler is not included in this release but may
be obtained by writing me.  The source is written in Lightspeed C
and will be on a Mac disk.



Release History.

Derived from source put on some network by Chris Lewis, 
who had enhanced SmallC v1, written by Scott Cain and
originally described in Dr. Dobb's Journal.  This compiler
did not therefore derive from Jim Hendrix's version, v2.
This compiler is of less quality than the Hendrix version.  
I did the port to Lightspeed C and wrote the code generator
from a version for the 6809.

This release must be considered an alpha version.  Testing has 
been minimal and is ongoing.  Users should be willing to 
work-around any bugs, and to inspect the generated code.




Limitations and Bugs

This compiler largely comforms to the version of SmallC documented
by Jim Hendrix in his book, "The SmallC Handbook", available from 
Dr. Dobbs Journal.  That is, C without reals, multidimensional 
arrays, records, bit fields, type casting, and so forth. Known 
exceptions are that the GOTO statement is not supported, and the result
type of functions cannot be declared.  You'll just have to try a 
language feature to be sure it is supported.

One known bug is that macro names over eight chars are not handled
properly but result in an error message saying the name is undefined.

I would appreciate bug reports but cannot guarantee fixes.




Notes about distributing this software.

Copyright 1987, Lloyd Konneker
111 Innsbruck Dr., Clayton, NC 27520
This program is FreeWare. 
You may copy and distribute it on a not-for-profit basis.